home *** CD-ROM | disk | FTP | other *** search
/ SGI Enlighten DSM 1.1 / SGI EnlightenDSM 1.1.iso / sunos41x / admin.z / admin / help / C / online0503.hlp < prev    next >
Text File  |  1998-06-30  |  16KB  |  420 lines

  1.     Create New User Account
  2.  
  3.     This window is used to create new user accounts. You can do this
  4.     individually or en masse. The Create New User Account window
  5.     also gives you the option to use default parameters, as
  6.     defined in the Configure --> New User Templates window. These
  7.     defaults ensure all new user accounts in a particular type are
  8.     created with consistent information (see "New User Templates" on
  9.     page 2-17 for more details).
  10.  
  11.  
  12.     If you leave one of the fields blank when adding a user account,
  13.     Enlighten will fill in the field with the default value (where
  14.     possible) or prompt you for any additional information. After you've
  15.     filled in all the fields properly and clicked on the Add button,
  16.     Enlighten will create the user account and home directory, update
  17.     the appropriate naming service, and create the home directory with
  18.     the required shell scripts.
  19.  
  20.     Fields
  21.  
  22.     You can fill in all of these fields manually or have Enlighten set
  23.     defaults in most of the fields for you. Either way, you need to
  24.     specify the following five fields before trying to add the user
  25.     account.
  26.  
  27.     Hostnames
  28.  
  29.     If you want to limit the creation of this account to specific
  30.     hostnames within a pool, enter those hostnames in this field. If you
  31.     are using multiple entries, leave a blank between each entry. You
  32.     can also use the arrow button to the right to select the available
  33.     hosts from the current pool.
  34.  
  35.     Login name
  36.  
  37.     The Login name is a unique name which identifies a user account. A
  38.     user needs a login and a password to gain access to the system. The
  39.     login name must be unique and the first character should be set in
  40.     lower case (e.g., cHE034). You may also use macros in this field.
  41.     See "User Account Macros" below for more details.
  42.  
  43.     Real name
  44.  
  45.     This is the user's actual name. This field can identify a person,
  46.     company, or organization. You can use this field to associate the
  47.     sometimes cryptic Login name with the actual user's name. On larger
  48.     systems, this name matching is invaluable.
  49.  
  50.     Office
  51.  
  52.     This field should contain the location where the user will normally
  53.     access the system. The field can be an office number, an assigned
  54.     location code or a department name. This field does not allow
  55.     punctuation characters.
  56.  
  57.     Telephone
  58.  
  59.     This field can contain the telephone number, telephone extension, or
  60.     some other information to help locate and contact the user. The
  61.     format of the field is user definable.
  62.  
  63.     At this point you can have Enlighten automatically fill in the
  64.     remainder of the form by clicking on the Add button. The default
  65.     values entered depend on the values set in Configure --> New User
  66.     Templates window.
  67.  
  68.     Otherwise, you should fill-in the rest of the fields yourself. The
  69.     fields and their defaults are:
  70.  
  71.     User ID
  72.  
  73.     This field contains the UID number. The UNIX operating system uses
  74.     this number to identify each user. This number does not have to be
  75.     unique, but should be for easier system administration. Enter the
  76.     UserID number to be assigned to this user account.
  77.  
  78.     If the New User Template you're using is set to automatically
  79.     generate a unique UID, then this field will be initialized with that
  80.     number. 
  81.  
  82.     Note: If this field is left blank, Enlighten will prompt you for an
  83.     entry in this field when it tries to create the user.
  84.  
  85.     Home dir.
  86.  
  87.     The Home dir. field specifies where the user's start-up directory is
  88.     attached. Most systems will use /usr or /home as the default parent
  89.     directory. Each user will have their own directory created under the
  90.     default home directory, e.g. /usr/charlie. Enlighten stores /usr as
  91.     the default HOME directory unless you change this field.
  92.  
  93.     If you specify a HOME directory which does not exist, Enlighten
  94.     creates and initializes it. Enlighten initializes the HOME directory
  95.     by executing the HOME directory initialization script
  96.     $ENLIGHTEN/scripts/user.rc. This copies the initialization files
  97.     (e.g., .profile and .cshrc) into the HOME directory. You can modify
  98.     this script to perform other initialization procedures. These
  99.     procedures are not done on the Windows NT platform.
  100.  
  101.     Windows style paths may also be entered, e.g. c:\users\charlie.
  102.     However, this path will be converted to //c/users/charlie on any
  103.     UNIX platform that is in the current hostnames selection field or
  104.     in the current pool. This can be changed by entering two paths.
  105.     The following examples show valid entries:
  106.  
  107.             c:\users\charlie|/home/charlie
  108.             /home/charlie|c:\users\charlie
  109.             /home/charlie|\users\charlie
  110.  
  111.     The symbol '|' is the pathname delimiter. Only one can occur in the
  112.     field. Each individual pathname must not contain both '/' and '\'. 
  113.     A zero length pathname is an error condtion.
  114.  
  115.     You may also use macros in this field. See "User Account Macros" below
  116.     for more details.
  117.  
  118.     Shell
  119.  
  120.     The Shell is a program that acts as a translator between the user
  121.     and the UNIX operating system. There may be several standard shells
  122.     on a system, including the C Shell, the Bourne Shell, the Korn Shell
  123.     and the restricted Bourne, C and Korn Shells. This, however, does
  124.     not stop experienced users from creating custom shells. Each shell
  125.     has its own start-up executable program as shown on the following
  126.     page.
  127.  
  128.         Bourne Shell /bin/sh
  129.  
  130.         Restricted Bourne Shell /bin/rsh
  131.  
  132.         C Shell /bin/csh
  133.  
  134.         Korn Shell /bin/ksh
  135.  
  136.         Restricted Korn Shell /bin/rksh
  137.  
  138.         Other user defined
  139.  
  140.     Enlighten uses the Bourne shell as the default shell in this field
  141.     (/bin/sh). All users on the system do not have to use the same
  142.     shell; this is a matter of user preference, as each shell offers
  143.     different functionality. The number of standard shells available for
  144.     this field depends on your system. Click on the arrow button to
  145.     display a pick list of available shells.
  146.  
  147.     Group name
  148.  
  149.     Every user account must be assigned to at least one User Group. The
  150.     User Group is part of the UNIX security system; each user group has
  151.     specific read, write, and execute privileges associated with every
  152.     file created on the system.
  153.  
  154.     Enter the primary Group name for this user or leave this field blank
  155.     to have the default assigned. Click on the arrow button for a pick
  156.     list of defined User Groups. If you enter a Group Name which does
  157.     not exist, Enlighten will prompt for a correct Group Name when it
  158.     tries to create the user.
  159.  
  160.     Add Groups
  161.  
  162.     You can use this field to put the user in additional user groups.
  163.     This will effectively give the user more group privileges beyond
  164.     those set in the primary user group. Enter the names of the user
  165.     groups to which the user should also belong. Click on the arrow
  166.     button for a pick list of defined User Groups. Select the User
  167.     Groups and click on the Apply button to import them.
  168.  
  169.     Password
  170.  
  171.     The password is part of the UNIX security system. Each user must
  172.     have a password. If you make the password the same as the user
  173.     login, the user can then reset the password to one of his or her own
  174.     choice. Don't use passwords such as spouse names, pet names, or
  175.     addresses, they are easy for another user to guess. You may also use
  176.     macros in this field. See "User Account Macros" below for more
  177.     details.
  178.  
  179.     Note: If the entry in the password field is not long enough, an
  180.     error message will be displayed when you try to add this user
  181.     account.
  182.  
  183.     Expires
  184.  
  185.     For systems that support password aging, this optional field
  186.     contains the time when the password will expire. Once a password has
  187.     expired, the system will force the user to change their password the
  188.     next time they login to the system.
  189.  
  190.     If this field is left blank, the appropriate default parameter will
  191.     be used. If no default is set in the User Add window (when you're
  192.     adding a user), password aging will be turned off for that user.
  193.  
  194.     To specify a time format, see "TIME FORMATS" below.
  195.  
  196.     Span
  197.  
  198.     In conjunction with the Expires field, this field defines the
  199.     minimum period of time which needs to elapse before the user can
  200.     change his or her password. You can, however, change the user's
  201.     password at any time by using the Password button in the User
  202.     Configuration window.
  203.     To specify a time format, see "TIME FORMATS" below. 
  204.  
  205.     Mail Alias
  206.  
  207.     This field specifies the default mail alias the account will use. An
  208.     alias designates a short name as the substitute for the full
  209.     pathname for a particular user or group. You may also use macros in
  210.     this field, see "User Account Macros" below for more details.
  211.  
  212.     Mail Lists
  213.  
  214.     This field specifies which mailing lists will be updated to include
  215.     this user. A mail list defines a group of people under one alias, so
  216.     sending mail to that alias will distribute a copy everyone on that
  217.     list. Click on the arrow button for a pick list of defined Mail
  218.     Lists.
  219.  
  220.     Buttons
  221.  
  222.     This window contains the following buttons.
  223.  
  224.     Add
  225.  
  226.     Once you've entered the relevant information, click on the Add
  227.     button to create the user. If the information is incorrect use the
  228.     mouse to navigate through the fields and make the necessary changes.
  229.     When complete, click on the Add button again.
  230.  
  231.     Clear Fields
  232.  
  233.     Click on this button to clear the existing choices in all fields.
  234.  
  235.     Multi-User Add
  236.  
  237.     Refer to "Multi-User Add" on page 4-9 to use this button and the
  238.     window it generates.
  239.  
  240.     Template
  241.  
  242.     Click on this button for a pick list of defined New User Templates.
  243.     You can use one of this templates to populate default values in the
  244.     new user's account, make any necessary changes, and then Add the
  245.     user. Only those field which are currently blank (in the Create New
  246.     User Account window) will be initialized from your selected
  247.     template.
  248.  
  249.     Close
  250.  
  251.     Click on this button to discard any changes and close the window.
  252.  
  253.  
  254.     USER ACCOUNT MACROS
  255.  
  256.     You can use macros to help initialize the form fields when you
  257.     create a User Account. You can enter these macros manually. Or you
  258.     can have them fill (some of) the form fields automatically by first
  259.     defining them in a New User Template and using that template when
  260.     you create the user account.
  261.  
  262.     The following types of fields accept macros in these two windows:
  263.  
  264.     + Login Name
  265.     + Home dir.
  266.     + Password
  267.     + Mail Alias
  268.  
  269.     For working examples, see "Macro Name" on page J-3.
  270.  
  271.     Format
  272.  
  273.     A macro has the following format:
  274.  
  275.         %<Modifiers><Macro Name>
  276.  
  277.     Modifiers
  278.  
  279.     <Modifiers> are optional (you can define them multiple times). You
  280.     can use the <Modifiers> to specify only specific parts of the field,
  281.     such as the first letter of the field, or to manipulate and convert
  282.     the given input.
  283.  
  284.     A modifier has the following format:
  285.  
  286.  
  287.     [<Converter><Range>]
  288.  
  289.     where <Converter> is one or more of the following characters:
  290.  
  291.         l - Convert the resulting string to lower case
  292.         L - Same as `l'
  293.         u - Convert the resulting string to upper case
  294.         U - Same as `u'
  295.         s - Do not include SPACEs
  296.         S - Same as `s'
  297.         _ - Replace SPACEs with underscores (_)
  298.  
  299.     and the <Range> applies to the complete string in the field (by
  300.     default). Or you can apply a range to a specific word in the input
  301.     string.
  302.  
  303.     Consequently, a <Range> has the following format:
  304.  
  305.         $<word number><Character Range>
  306.  
  307.     where <word number> shows the word's sequence in the string (this is
  308.     optional). The first word would be addressed as $1, the second word
  309.     as $2, and so on. You can also use $0 to address the first word.
  310.  
  311.     <Character Range> is a comma separated list of character ranges in
  312.     the form. If you specify a <word number>, you must first use a comma
  313.     (`,') in the range list.
  314.  
  315.     The character range itself has the following format:
  316.  
  317.         <start char>-<end char>
  318.  
  319.     where <start char> and <end char> are character numbers. You can
  320.     omit one end of the range to signify the "start of string" and "end
  321.     of string" respectively. Ranges which go beyond the end of the
  322.     string are truncated to match the string.
  323.  
  324.     Macro Name
  325.  
  326.     <Macro Name> is one of the following characters:
  327.  
  328.         g - replace with the users' GID
  329.         u - replace with the users' UID
  330.         G - replace with the users' group name
  331.         U - replace with the users' login name (username)
  332.         R - replace with data from the users' Real Name field
  333.         O - replace with date from the users' Office field
  334.         T - replace with date from the users' Telephone field
  335.  
  336.     Examples
  337.  
  338.     These definitions make more sense when they are viewed as examples.
  339.     Assume for the following example, the following data is true:
  340.  
  341.         Real Name: Thomas Kraus
  342.         Login Name: tmk
  343.         UID: 302
  344.  
  345.     You could then define the following macros and see the following
  346.     substitutions.
  347.  
  348.         Field Name   Macro               Value
  349.         -------------------------------------------
  350.         Home Dir     /home/%U           /home/tmk
  351.         Password     %U-%u              tmk-302
  352.         Mail Alias   %[u$1]R_%[u$2]R    THOMAS_KRAUS
  353.         Login Name   %[l$1,1][l$2,-6]   tkraus
  354.  
  355.     Some explanations:
  356.  
  357.     /home/%U Create the directory /home/<login name>
  358.  
  359.     %U-%u Get the User name and add the UID (separated by a dash)
  360.  
  361.     %[u$1]R_%[u$2]R Get the first word of the users' real name and add
  362.     the second word of the user's real name (separated by an
  363.     underscore). Convert both strings to upper case.
  364.  
  365.     %[l$1,1][l$3,-6]R Take the first letter of the users first name and
  366.     the first six letters of the users' last name. Convert both strings
  367.     to lower case.
  368.  
  369.  
  370.     TIME FORMATS
  371.  
  372.     There are several fields throughout the Enlighten product where you
  373.     can specify a date/time format. For each of these fields, you can
  374.     specify the date and/or time period in two ways: absolutely or
  375.     relatively.
  376.  
  377.     The first is as a static period, where the period entered is the
  378.     absolute period used in the search. This is the only way to search
  379.     for a combined date/time format. To look for a file created since
  380.     May 10, 1996 at 12 noon, you could use the entry: May 10 96 at
  381.     12:00.
  382.  
  383.     The second is a relative period, where the period entered is set
  384.     against the current system clock time and then applied during the
  385.     search. This is strictly a time OR date format, e.g., 2 seconds or 1
  386.     month. To find users who have been logged in during the last three
  387.     days, you could use the entry: 3 days.
  388.  
  389.     Either way, the format is case-insensitive. For example, you could
  390.     use JAN, Jan, or jan as the abbreviation for the month of January.
  391.     This appendix shows all the BNF time measurements in initial caps
  392.     (e.g., Jan or January, 2 Sec or 2 Seconds, etc.).
  393.  
  394.     Some typical uses of the static format in a Date search field are:
  395.  
  396.     Absolute: 15 1996 (defaults to the current month)
  397.  
  398.         Jan 1 97
  399.         July 4 (defaults to the current year)
  400.  
  401.     Some additional uses of the absolute format in a Time search field
  402.     are:
  403.  
  404.         June 15 at 3 PM (defaults to the current year)
  405.         June 16 at 2AM (defaults to the current year)
  406.         June 17 96 at 15:31
  407.         18 at 9:31:14 AM (defaults to current month AND year)
  408.  
  409.     Some typical uses of the relative format in a Date search field are:
  410.  
  411.         Relative: 1 second
  412.  
  413.         5 Min
  414.         1 day
  415.         2 weeks
  416.         1 Year
  417.  
  418.     The rest of this appendix defines the time formats you can use
  419.     whenever you fill in a date and/or time field.
  420.